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- PARPLT PROGRAM 


1.0 SCOPE 

This document contains the description of the implementation of the PATTPIT 
program. The purposes of the program are as follows; 

(1) To produce scatter plots of the greenness profile derived parameters 

a, 3, and t^ computed by the CLASFYG program. Alpha is the approximate 
greenness rise time, beta is the approximate greenness decay time, and 
is the spectral crop emergence date. 

(2) To produce statistical information concerning the a, 3» and t^. 


2.0 APPLICABLE DOCUMENTS 


The following documents fttm a* part of this specification: 

AD 63-2457-3308-03 Transferring Badliwar Software. 

AD NAS 9- 152C0 Technical Memorandum Format Specifications for LACIE (Phase III) 
and Accuracy Assessment Computer Data Products. 
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3.0 "SYSTEM DESCRIPTION 


3.1 SYSTEM FLOWCHART 

The system level data flow diagram for the PARPLT Program is depicted In 
Figure 3.3.1. A program hlerarc.hy Is shown In Figure 3.1.2. 


PARPLT 


ICE 


....PPLTIN.... 

....CCPTIME 

....JULIAN 
....RVALUE 
....CROPP 
...SCAT 


I VALUE 


PACK 

UNPACK 


Figure 3.1.2 Hierarchy diagram for the PARPLT Program. 
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3.2 HARDWARE DESCRIPTION 

■ W I W III W I W II I i j > i[ i.ili ii iiiiiip» l WWIMW« M i*i >iw (I * Ii m 

The software for the PARPLT Program Is operational on the IBM 3031 computer 
at PURDUE. 

3.3 SOFTWARE DESCRIPTION 

PARPLT was designed to produce scatter plots of the parameters a, 3, and 
computed by the CLASFYG Program. Alpha Is the approximate greenness rise 
time, beta Is the approxima'- ecay time, and t^ Is the spectral crop 
emergence date. Three types ■ -a lots are produced; namely (1) a vs. 3, 

(2) a vs. t^, and (3) 3 vs, t . :ny given run, plots can be obtained 
for up to three categories. A catsj.ry can be a single ground truth class 
like “spring wheat", or a combination of ground truth classes like "small 
grains". Ground Truth codes are mapped to specific categories through a 
"ground truth transformation" table. (See Section 3.4.2 for a complete 
description of the ground truth transformation table.) 

Ground truth data Is used In the process oF determining If a specific pixel 
value IS among the categories chosen to be plotted. The program processes 
each pixel In the following manner: 

(1) Through the use of the ground truth transformation table a transformed 
numeric code Is assigned to each of the six ground truth sub-pixels 
which correspond to the given pixel. 

(2) The pixel Is assigned to a majority category. This majority category 
Is either the category of the first subpixel or Is the category 
which occurs the most among the six sub-pixel categories. 

(3) The number of occurance of the majority category is defined to be the 
purity of the given pixel. This purity Is compared to a user 
specified p'xel purity range, and If the number of occurances fall 
outside of this range then there Is no further processing of this 
pixel . 

(4) If the majority category Is greater than the number of categories 
specified by the user then there Is no further processing of this 
pixel . 
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(5) If the pixel value of "the classification parameter a Is zero then 
there Is no further processing of this pixel, 

(6) Each of the plots are ucipated according to the classification 
parameter to reflect the occurahce of an additional pixel. 

(7) Statistical variables are updated. 

When each pixel has been processed the program computes statistical Informa- 
tion for all pixels, a»>d the plots and statistical Information are printed. 
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3.4 FILE DESCRIPTIONS 
3.4.1 INP UT FILE(S) 

Two Input data f11e« are required tq execute the PARPLT program. The two 
files and their descriptions are as follows: 

PARPLT accepts as Input, a classification file output from the CLASFYG 

PROGRAM. This classification file consist of 118 records. The first 

record Is a header record consisting of 3060 bytes. The header record 

follows universal format requirements. Records 2-118 contain data records. 

Each data record consists of 196 pixel vectors. Each pixel vector consists 

2 

of four coefficients: a, 6, t^ and x . Each coefficient contains a 
signed Integer value stored In a 32 -bit full word. (For a complete 
description of this file see "AS-BUILT" DESIGN SPECIFICATION FOR CLASFYG). 

The Ground Truth file 1;. In UNIVERSAL FORMAT with one channel per physical 
record. There are 351 records of length 540 8 bit-bytes. The contents 
of each byte have been biased with -128 and are stored In 8 bit twos- 
complement notation. (For a complete description of the file see Earth 
Resources Data Format Control Book, Volume 1, PH0-TR543.) 
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USER DET ’ED FILE (SYMBOL FILENAME) (SYMBOL FILETYPE) A 
: "'2 is to specify (1) the pixel purity range and (2) the ground 

cceptable pixel purity for any given 
r a complete description of pixel purity 
transformation allows the user to map 
ssification Categories". These 

: .id ” cal order of the categories entered on 

.rd in . . .red control card file (See Section 3.4.3 
i .S3; : concerning :ne use of this card). Therefore, any 

a:; snt of :p code to a category greater than the total number of 



' ”'as ent.3 

signifies 

that the code is of no interest. If a cy’.op 

- : 

: not as; ' 

3d to a category the program assigns as a default a 


. 'V 0 f 6 . "'i 

e last entry in the symbol file must be 0 0 0. 

1 1 j 

•'.'’St entry in 

the symbol 

file is as 

f 0 1 1 ows : 

cy .. 

,n 1 

2 

3 


T 

n 

IX 

ni 

Purpose 


start 


• 

• 

end : 

Defines the start and end of a 
range of pixel purity. 

T\ , 

i^aining entries in the symbol file 

are as follows; 

Cc’ : 

”ns 1-5 

6-10 

11-15 


F-:-~ 

15 

15 

15 

Purpose 


start 

end 

category 

Defines the start and end of a 
range of crop values assigned to 
a category. 


0 

0 

0 

Signifies the end of Ground Truth 


transformation information. 
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The following is an example of a symbol file. 
.16 


1 

10 

1 

11 

20 

2 

21 

79 

3 

80 

80 

6 

84 

86 

2 

127 

127 

3 

164 

164 

6 

165 

165 

3 

0 

0 

0 


3-8 


3.4.3 USER DEFINED FILE (FILENAME) CC A 

This Control Card file is used to specify inputs to the PARPLT program. 


The inputs are on card image records’. Each record consists of (1) a keyword which 
is ten characters or less and begins in the first card column arid (2) input 
parameters in columns 11 through 72. The following description lists the 
keywords and describes the corresponding inputs. 


KEYWORD 

ALPHARNG 


BETARNG 


TCfRNG 


CROP 


ACCEPTABLE INPUT3 
Pair of postive numbers 


Pair of positive numbers 


Pair of positive numbers 


1-3 crop names 


DESCRIPTION 

This card defines the minimum and 
maximum values to be p’lOtted for the 
Alpha parameter. The numbers are 
assumed to be positive real numbers 
and any integers will be converted. 
The numbers are separated by any 
delimiter except ' . 

This card defines the minimum 
and maximum values to be plotted 
for the beta parameter. The 
numbers are assumed to be positive 
real numbers and any integers 
will be converted. The numbers 
are separated by any delimiter 
except ' . ' . 

This card defines the minimum 
and maximum values to be plotted 
for that parameter. The numbers 
are assumed to be positive real 
numbers and any integers will be 
converted. The numbers are 
separated by any delimiter 
except ' . ' . 

This card gives names(s) to the 
categories to be“plot‘ted. ' The 
categories are separated by any 
non char acter deliminter exce pt 
a 'blank . "Embed ded bla nks 
are"considere(Tpart of’a 
categories* name. 


AI Analyst's name 
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This card specifies the analyst's 
name for report identification 
and is an optional input. 




.. 1:^ 


KEYWORD 

ACCEPTABLE INPUTS 

DESCRIPTION 

DATE 

Free form 

This card gives the date for 
report identification and is an 
optional input. 

SEGMENT 

Segment number 

This card specifies the segment 
number for report identification 
and is an optional input. 

*END 

Ignored 

This card identifies the end of 
the user defined cards. 


An example of a control card file follows; 


AI 

SEGMENT 

DATE 

ALPHARNG 

BETARNG 

TORNG 

CROP 


MARY ANN TOMPKINS 
0882 

APRIL 1, 1981 
0.0 4000.0 

0.0'- 3600.0 
1000.0 2000.0 
CORN, SOYBEAN, OTHERS 
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3.5 SOFTWARE DESCRIPTION 


3.5.1 PARPLT 
Purpose 

(1) To produce scatter plots of the greenness profile derived parameters 
a. S» f»*om the CLASFYG program. Alpha is the approximate greenness 
rise time, Beta is the approximate greenness decay time and t^ is the 
spectral crop emergence date. 

(2) To produce statistical information concerning the a, 3, t^ parameters 
computed by the CLASFYG program. 

Linkages 

PARPLT calls subroutine PPLTIN, SCAT. 

Interface 
Calling sequence: 

N/A (PARPLT EXEC which loads and executes PARPLT is described in 
Section 4.0) . 

Calling sequence parameters: 

None applicable. 

Function value; 

None applicable. 

Labeled COMMON parameters: 


Full description of labeled COMMON 

blocks are 

contained in Appendix A. 

Label 

Variable 

Name 

Element 

Position 

Input/ 

Output 

Description 

/PLOT/ 

RXMX(IO) 

1 

0 

X min of X,Y plot 
coordi nate.. 


RXMN(IO) 

2 

0 

X max of X,Y plot 
coordinate. 
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Label 

Variable 

Name 

Element 

•Position 

Input/ 

Output 

Description 


RYMX(IO) 

3 

0 

Y min of X,Y plot 
coordinate. 


RYMN(IO) 

4 

0 

Y max of X,Y plot 
coordinate. 

/NSBIXL/ 

NSDBPX(6) 

1 

0 

6 subpixel values that 
map i .0 a pixel . 

/HEADER/ 

RHEAD(18,20) 

1 

0 

Heading printed on 
Individual map. 

/DEF6T/ 

6TRSEG(3) 

1 

0 

Ground truth segment 
number. 


TYR 

2 

0 

Year ground truth file 
created. 


GTDATE(3) 

3 

0 

Julian date ground truth 
file created. 

/DEFKL/ 

KLA3E3 

1 

0 

Segment used to generate 
class file. 


KYR 

2 

0* 

Year class file created. 


KLDATE(3) 

3 

0 

Julian date class file 
created. 


Blank COMMON parameters: 


None. 



Inputs 

Unit 

Im. 

Description 

9 

Sequential data. 

Ground truth file (See Section 3.4.1). 

10 

Sequential data. 

Classification file (See Section 3.4.1 

19 

Sequential data. 

Symbolic mapping elements, pixel purity 
range (5ee Section 3.4,2). 
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^sscriotion 

'.un r: -0 cUagnc’ : . 
3 k ' Plot report. 


'ins r* * .‘'3!T'3r 

: applicable. 


Description 

Ground truth data is used in the process of determining if a specific pixel 
value is among the categories chosen to be plotted. The program processes 
each pixel in the following manner: 

(1) Through the use of the ground truth transformation table a 
transformed numeric code is assigned to each of the six ground 
truth sub-pixels which correspond to the given pixel. 

(2) The pixel is assigned to a majority category. This majority 
category is either the category of the first subpixel or is the 
category which occurs the most among the six sub-pixels categories. 

(3) The number of occurance of thei majority category is defined to be 
the purity of the given pixel. This purity is compaired to a user 

specified pixel purity range, and if the number of occurances 
fall outside of this range then there is no further processing 
of this pixel . 

(4) If the majority category is greater than the number of categories 
specified by the user then there is no further processing of this 
pixel. 

(5) If the pixel value of the classification pa ramenter a is. zero 
then there is no further processing of this pixel. 

1 

(6) Each of the plots are updated according to the classification 

! parameter to reflect the occurance of an additional pixel. 

I 

' (7) Statistical variables are updated. 
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the program outputs statistical 
-• plots and statistical information are 


m listing. 


ORIGINAL PAGE IS 
OF POOR QUALITY 


3.5.2 SUE" 

Purpose 

CROPP acc 2 
of the su 

V 

Linkages 
CROPP 1s . 

Interface 

Calling sec 
CALL cr. ■ 

Calling sec: , • 

Arqumen : __ _ _ 

KROP 

IXLCNT 

Function valus; 

Not appi * 2 . 

Labeled COMf'C" . 
Full des : 

Label _____ _ 

/NSBIXL/ 

Blank COWOM r.rirst.- ; : 
None. 


:s a pixel value representative 


_T_ 

:."op code. 

.mber subpixels that match the 
:ce . 


blocks are contained In Appendix A. 
Input/ 

Output Description 

I Subpixels that map to 

a pixel . 


n 


vay#iniivs^’! VI - 

OF QyALlTY 


Inputs 
None . 

Outputs • 

None. 

Storage requirement 
Not appi icable. 

Description 

The first sub-pixel value upon entry is considered to be the majority pixel 
(KROP) value. The NSUBPX array is traversed and the number of codes equal 
to KROP counted. This proceuure continues until a count of each unique 
code is made. If at anytime a count becomes greater than the count of KROP 
this code becomes KROP's value. 

Fl owchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 


3.5.3 FUNCTION ICE 
Purpose 

To established the Integer character equivalence of a byte. 

Linkages 

ICE is called by PPLTIN. 

Interface 

Calling sequence: 

K - ICE (INT). 

Calling sequence parameters; 

Input/ 

Argument Output Dascription 

INT I One byte in character form. 

Function value: 

Name Description 

K One byte in computation form. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 

Blank COMMON parameters: 

None. 

Inputs 

None. 

Outputs 

None. 
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storage requirement 
Not applicable. 


Description 

ICE sets the Input parameter to the function and returns. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for function listing. 


3.5.4 FUNCTION IVALUE 
Purpose 


To allow the tn line storage and testing of Integer quoted literals. 

LI nkaqes 

IVALUE Is called by PPLTIN. 

Interface 

Calling sequence: 

K » IVALUE (INT). 

Calling sequence parameters: 

Input/ 

Argument Output 
INT I 

Function value: 

Name Description 

K Quoted literal. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained In Appendix A. 
None. 

Blank COMMON parameters: 

None. 

Inputs 
None . 


Description 

Quoted literal declared Integer. 


Outputs 

None. 
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storage requirement 
Not applicable. 


Description ' ' 

IVALUE sets quoted literals to Integer function and returns. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for function listing. 
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3.5,5 SUBROUTINE JULIAN 
Purpose 

To convert a Gregorian Calendar date to a Julian calendar date. 


Linkages 

JULIAN is called by PARPLT. 


I nterface 

Calling sequence^ 

CALL JULIAN (JDATE, 'iNERR, INDAY, INMNTH, INYEAR). 


Calling sequence parameters: 

Input/ 

Argument Output Description 


JDATE(3) 0 
INERR 0 

INDAY I 
INMNTH I 
INYEAR I 


Array to return Julian date. 

Error flag indicating in put value out o f range 
(zero returned if no'errbr occurred). 

Day of month. 

Month of the year. 

Last two digits of the year. 


Function value; 

Not applicable. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 


Blank COMMON parameters: 
None. 


Inputs 


None 
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Outputs 

None. 


Storage requirement 
Not applicable. 


Dascription 

If the input day is less than 1 or greater than 31, and Input month is 
less than 1 or greater than 12 set INERR = 1 for error flag and return. 
Compute Julian date from month and day. If the year is a Leap, year and 
the month is greater than two add one to the computed Julian date. 

Flowchart 
Not applicable. 

Listing 


See Appendix B for routine listing. 


3.5.6 SUBROUTINE PACK 


Purpose 

Packs the nunber of occurances that parameters map to a computed location 
in a byte. 

Linkages 

PACK is called by SCAT. 

Interface 
Calling sequence: 

'^LL PACK (LOTBLE, IX, IyV^IPLOT). 

Calling sequence parameters: 

Input/ 

Argument Output 
LOTBLE I 

IX I 

lY I 

I PLOT I 

Function value: 

Not applicable. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 

Blank COMMON parameters: 

None. 


Description 

Plot labels to count occurances of pixels. 
Column of LOTBLE (word). 

Row of LOTBLE. 

Number of plot to update. 


Inputs 

None. 
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Outputs 
None . 

Storage requirement 
Not applicable. 

Descri ption 

Compute the byte location to be updated. Store word from LOTBLE containing 
byte in temporary location (IWORD). Stpre computed byte in a temporary 
word. Add one to byte word and if greater than 255 return; else, change 
byte within IWORD to new value and store word back into LOTBLE. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for .routine listing. 
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3.5.7 SUBROUTINE PPLTIN' 


Purpose 


ReAdS, classifies, and analyzes- cards- describing the following: 


AI, SEGMENT, DATE, FILE 
ALPHARNG 

BETARNG- - - 

TORNG 

CROP 

*END 


DOCUMENTATION - READ AND WRITTEN. 

MIN MAX RANGE FOR ALPHA COEFS. 

MIN. MAX RANGE FOR BETA COEFS. 

MIN MAX RANGE FOR TO COEFS. 

1-3 CROPS TO MAP. ENBEDDED BLANKS 
ARE INCLUDED IN NAME. 

SPECIFIES THE END OF USER DEFINED CARDS. 


Li nkaqes 

PPLTIN is called by PARPLT. 

Interface 

Calling sequence: > 

CALL PPLTIN (NCROP, RCROP, RANGE, lERR) . 


Calling sequence parameters: 


Argument 

Input/ 

Output 

Description 

NCROP 

0 

Total number of user input crops. 

rcro7 ' 

0 

Crops to be evaluated. 

RANGE 

0 

Minimum, maximum of Alpha, Beta, and t^ 

lERR 

0 

Error flag 

Function value: 

Not applicable. 

0 - OK 

1 - error 


Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 
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Blank COMMON parameters: 
None. 


Inputs ' ■ . , 

Unit Type Description 

21 Seq. data User defined control card file (See Section 3.4.3) 


Ouputs 

Unit Type 

20 Printer 

5 Terminal 


Description 

Control card Input for report. 
Run time errors. 


Storage requirement 
Not applicable. 


Description 

PPLTIN processes each Input card. After the *E'ND card Is reached PPLTIN 
test for the following conditions: 

1. MORE/LESS THAN TWO NUMBERS ON THE ALPHA, BETA, TO RANGE CARDS. 

2. MIN>=MAX ON THE ALPHA, BETA, TO RANGE CARDS. 

3. ALPHA, BETA, TO RANGE CARD MISSING. 

4. MORE THAN THREE CROPS ON A CROP CARD. 

5. CROP CARD MISSING. ! 

If any of the conditions exist a diagnostic message Is Issued and lERR Is 
set equal to one. If a control card Is not recognized a warning message Is 
pri nted . 


Flowchart 
Not applicable. 


Listing 

See Appendix B for routine listing. 


3.5.8 SUBROUTINE SCAT 
Purpose 


SCAT updates the plots to reflect an. occurances of a pixel and outputs the 
actual plots. 

Linkages 

SCAT Is called by PARPLT. 


Interface 


Calling se quence; 

CALTsCAT (IB, IPLOT, XV, YV). 


Calling sequence parameters: 

Input/ 


Argument 

Output 

Description 

IB 

I 

Flag: 1 = Initilize plots to zero. 
2 = Update plots. 

3. = Output plots. 

IPLOT 

I 

The number of the plot to be considered 

XV 

I 

Column of the plot. 

YV 

I 

Row of the plot. 


Function value: 

Not applicable. 


Labeled COMMON parameters: 

Full description of labeled COMMON 


Label 

Variable 

Element 

Postion 

/PLOT/ 

XMY(IO) 

1 


XMN(IO) 

YMN(IO) 



blocks are contained in Appendix A. 

Input/ 

Ouput Description 

I X min of X,Y plot coordinate. 

I X max of X,Y plot coordinate. 

Y max of X,Y plot coordinate. 
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I 


Label 

Variable 

Element 

Position 

Input/ 

Ouput 

Description 

/HEADER/ 

RHEAD(18,20) 

1 

I 

Heading printed on 
individual map. 

/DEPOT/ 

6TRSEG(3) 

1 

I 

Ground truth segment 
number. 


TYR 

2 

I 

Year ground truth file 
created. 


GTDATE(3) 

3 

I 

Julian date ground truth 
file created. 

/DEFKL/ 

KLASES 

1 

I 

Segment used to generate 
class file. 


KYR 

2 

I 

Year class file created. 


KLDATE(3) 

3 

I 

Julian date class file 


created. 

Blank COMMON parameters: 

None . 

Inputs 

None. 

Ouputs 

Unit Type . Desdri ption 

6 Printer Report.file. 

Storage requirement 
Not applicable. 

Description 

SCAT initializes, updates, and outputs the scatter plots according to the 
value of IB. If IB=2 SCAT computes the address from the value of the 
parameters and then calls PACK to update the count of occurances to this 
address. If IB=3 SCAT calls UNPACK to retrieve the count of occurances and 


uses the count to Index Into ‘the IT array for a symbol to use In the 
actual plotting. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 
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3.5.9 SUBROUTINE UNPACK 
Purpose 

Unpack a byte and store the contents Into an Integer word. 

Linkages 

UNPACK Is called by SUBROUTINE SCAT. 

Interface 
Calling sequence: 

CALL SUBROUTINE UNPACK (IRET, LOTBLE, IX, lY, I PLOT) . 

Calling sequence parameters 

Input/ 

Argument Output 
IRET 0 

LOTBLE I 

IX I 

lY I 

IPLOT I 

Function value: 

Not applicable. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 

Blank COMMON parameters: 

None. 


Description 
Unpacked byte. 

Table containing the. byte. 

Column of location of word containing byte. 
Row of location of word containing byte. 
Plot within LOTBLE containing byte. 
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Inputs 

None. 


Outputs 

None. 

Storage requirement 
Not applicable. 

Description 

UNPACK computes the location within the word of the byte to UNPACK. The 
word containing the byte Is stored In a temporary location and the byte 
to be UNPACKED Is set equal to I RET. 


Flowchart 
Not applicable. 

Listing 

See Appendix B for routine listings. 
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3.5.10 FUNCTION RVALUE 
Purpose 

To allow Inline testing and storage of quoted literals declared real. 
Linkages 

RVALUE Is called by PARPLT. 

Interface 

Calling sequence: 

R ° RVALUE (REL). 

Calling sequence parameters: 

Input/ 

Argument Output Description 

REL I Quoted literals declared real. 

Function value: 

Name Description 

R Real variable. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained In Appendix A. 
None. 

Blank COMMON parameters: 

None. 

Inputs 

None. 

Outputs 

None. 
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storage reumrement 
Not applicable. 

Description 

RVALUE sets quoted literals to a real function and returns. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for function listing. 


•4.0 OPERATION 


4.1 OPERATING DESCRIPTION 

PARPLT 1s operational on the IBM 3031 computer at LARS, West Lafayette, 

Indiana. 

The PARPLT program Is one of the programs of the BADHWAR SYSTEM which Includes 
the programs CLASFYT, CLASFY6, MISMAP, PARPLT, PARHIS, and PARCLA. 

PARPLT requires the use of a D disk which Is assigned as a temporary disk 
and an E disk which Is used to load LARS routine onto. The user, therefore, 
must notassign a disk to his machine using either MODE E or MODE D. These 
disks, will be assigned as needed. 

Prior to executing the PARPLT program the user must (1) establish on his A 
disk a SYMBOL file as describe d In Section 3.4.2 and (2 ) establish the ^FtROL’ 
CARD file as described in Section 3.4.3, if he wishes to use this file. 

4.2 COMMANDS DESCRIPTION 

To execute PARPLT, the user enters a series of conmands which Invoke the JOB 
CONTROL SOFTWARE. These commands are divided Into two classes namely (1) 
FUNCTION commands and (2) PROGRAM commands. The FUNCTION commands, which 
perform all the functions except executing the program are reusable; I.e., 
once they are invoked they remain In effect until reentered. The PROGRAM 
commands, which execute the program, must be reentered each time the program 
is to be executed. 

The following list gives the commands required to execute the PARPLT program. 
They are all FUNCTION commands except the PROGRAM command PARPLT. Thesj 
commands must be given In the listed order except that the order of the 
DEFGTRU command and the DEFCLAS command may be Interchanged. 
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START 

DEFGTRU 


DEFCLAS 

PARPLT 

END ■ 

The following sections describe each of the commands in detail. Input fields 
are separated by blanks. If more than one word is required to describe an 
input field, the ^scriptive text is enclosed in pointed brackets <>. If 
an input is optional the field is enclosed fn square brackets []. Do not 
include these explanatory characters <> [] when actually submitting input 
to the computer. To enter a command the user types one input per defined 
input field and separates each field with a blank. 
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4.2.1 START 

The START command spools the user's console file. The use of this command, 
along with the END command, will provide a listing of all Information 
appearing on the user's console 1^le. (If running an Interactive job, this 
Is the terminal. If running a batch job this Is a system defined device). 
The START command Is Invoked by the user typing the fallowing: 


START 


4.2.2 DEFGTRU 

The DEFGTRU command defines a Ground Jruth. file. The user can use. this • 
command to define- Ground Truth files' on tape, disk, or may request the use 
of a file from the LARS RT&E Data Base. If the data nsquest is for the use 
of a file from the LARS Data Base a series of programs are invoked to provide 
interface with the data base. The following diagram illustrates his software 
flow. 

..RTEERR (LARS ROUTINE) 

DEFGTRU GTRUINF..,.: GTINFO (LARS ROUTINE) 

For a detailed description of the above JOB CONTROL SOFTWARE See Appendix B. 

The DEF GTRU coiraiand has the following forms and is invoked by typing one of 
the following, according to the user's requirement. 

’■f the file is on tape - 

DEF GTRU / TAPE# FILE# < TAPE DENSITY > 

If the file is on disk - “ 

defgW filename filetype filemode 

If the file is on the LARS Data Base - 

D EFGTR U/ SEGMENT# YEAR 

(year-last two digits of data generation year) 

This command remains in effect for the use of any of the BADHWAR SYSTEM 
PROGRAM commands and does not have to be reissued unless the user wishes to 
redefine the input Ground Truth File. 


4.2.3 OEFCLAS 


I 


The DEFCLAS command define? the input Classification file.. The user can. . 
use this command to define a Classification file on tape or disk. The 
DEFCLAS command has the following forms and is invoked by typing one of the 
following, according to the user's requirement. 

If the file is on tape - 

DEFCLAS TAPE# FILE# < TAPE DENSITY > 

If the file is on disk - 

DEFCLAS FILENAME FILETYPE FILEMODE 

This command remains in effect for the use of any of the BADHWAR SYSTEM 
PROGRAM commands and does not have to be reissued unless the user wishes 
to redefine the input Classification File. 


4-5 


4.2.4 PARPLT 

The PARPLT command Is a PROGRAM command Is used to Invoke the execution of 
the PARPLT program. This command must not be used unless the DEFCLAS and the 
DEFGTRU FUNCTION commands havffbeen previously Issued. Also, as previously 
stated the user must have established a SYMBOL FILE and a CONTROL CARD FILE on 
his A disk before Invoking this command. The PARPLT command Is Invoked by 
the user typing the following: 

PARPLT < sfliSrpTLENAME > < SYMBOL FILETYPE > < CONTROL CARD FILENAME > " 

The output from the PARPLT program Is spooled to the HOUSTON line printer. 

The output consists of a SCATTER PLOT and the USER INFORMATION file. 


4.2.5 END 


This conwand closes the user's console file and causes a spooled copy to be 
sent to the HOUSTON printer. This command has no effect if the START command 
was not previously issued. The END command is invoked by the user typing the 
following. 

END 
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4.3 OPERATING EXAMPLE 


For our example we will assume the following: 

The symbol file Is established on the user's A disk under the file descrl|i±ion; 
PARPLTl DATA A. 


The control card file Is established on the user's A disk under the file 
description: PARPLTl CC A. 

The user has two different Classification files which he wishes to Input to 
the PARPLT PROGRAM. He will therefore, Issue two PROGRAM commands In his 
command sequence. 


Furthermore, the user has elected to use a ground truth file at LARS. 


COMMAND 

START 

DEFGTRU 882 79 . 

DEFCLAS 088279 079 B 

PARPLT PARPLTl DATA PARPLTl 
DEFCLAS 2345 23 1600 

PARPLT PARPLTl DATA PARPLTl 
END 


EXPLANATION OR ACTION TAKEN 

Spools the console file. 

Defines a ground truth file using data from 
the LARS Data Base. 

Defines a Class file on the users B disk. 

This data Is on a disk which the user has 
previously attached to his disk using a B 
mode. 

Executes the PARPLT PROGRAM. 

Redefines the class file. This file Is from 
a 1600 BPI tape. 

Executes the PARPLT PROGRAM. The user has 
chosen to define his symbol file and CC file 
the same as In the previous execution of PARPLT. 

Closes the user's console file and spools the 
files to the HOUSTON printer. 
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APPENDIX A 
COMMON BLOCKS 


COMMON BLOCKS 


/NSBIXL/ NSUBPX(6) 

NSUGPX Six subpixels that map to a pixel. 

/DEPOT/ GTRSEG, TYR, GTDATE(3) 

GTRSEG Ground truth segment number. 

TYR Year of ground truth file creation. 

GTDATE Julian date of ground truth file creation. 

/DEFKL/ KLASEG, KYR, KLDATE 

KLASEG Classification segment number. 

KYR Year of classification file creation. 

KLDATE Julian date of classification creation. 

/PLOT/ RXMX(IO), RXMN(IO), RYMX(IO), RYMN(IO) 

RXMX X maximum for X, Y plot coordinate. 

RXMN X minimum for X, Y plot coordinate, 

RYMX Y maximum for X, Y plot coordinate. 

RYMN Y minimum for X, Y plot coordinate. 

/HEADER/ RHEAD(18,20) 

RHEAD Heading information for plots. 


APPENDIX B 
PROGRAM LISTINGS 
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APPENDIX C 
JOB CONTROL SOFTWARE 
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